Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Utility Functions

VDSetDigitizerUserInterrupt

The VDSetDigitizerUserInterrupt function allows applications to set custom interrupt functions.

pascal VideoDigitizerError VDSetDigitizerUserInterrupt 
                                    (VideoDigitizerComponent ci, 
                                    long flags, 
                                    VdigIntProc userInterruptProc,
                                    long refcon);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

flags

Indicates when the interrupt function is to be called. Applications may set more than one flag to 1. The following flags are defined:

Bit 0

Calls the interrupt function on even-line fields. If this flag is set to 1, the video digitizer component calls the custom interrupt procedure each time it starts to display an even-line field.

Bit 1

Calls the interrupt function on odd-line fields. If this flag is set to 1, the video digitizer component calls the custom interrupt procedure each time it starts to display an odd-line field.

userInterruptProc

Contains a pointer to the custom interrupt function. Applications set this parameter to nil to remove a custom interrupt function.

Every custom interrupt function must support the following interface:

            pascal void MyInterruptProc (long flags, long refcon);

See page 8-98 for details on the parameters of the MyInterruptProc function.

refcon

Contains parameter data that is appropriate for the interrupt procedure.

DESCRIPTION

The video digitizer component calls these custom interrupt functions during field or frame interrupt processing. The application function can then perform special processing.

RESULT CODES

noErr	0	No error
digiUnimpErr	-2201	Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help